package com.ruoyi.distributor.mapper;

import java.util.List;
import com.ruoyi.distributor.domain.DistributionUser;
import com.ruoyi.wallet.domain.DistributionWallet;

/**
 * 分销用户信息Mapper接口
 * 
 * @author ruoyi
 * @date 2025-10-11
 */
public interface DistributionUserMapper 
{
    /**
     * 查询分销用户信息
     * 
     * @param distributorId 分销用户信息主键
     * @return 分销用户信息
     */
    public DistributionUser selectDistributionUserByDistributorId(Long distributorId);

    /**
     * 查询分销用户信息列表
     * 
     * @param distributionUser 分销用户信息
     * @return 分销用户信息集合
     */
    public List<DistributionUser> selectDistributionUserList(DistributionUser distributionUser);

    /**
     * 新增分销用户信息
     * 
     * @param distributionUser 分销用户信息
     * @return 结果
     */
    public int insertDistributionUser(DistributionUser distributionUser);

    /**
     * 修改分销用户信息
     * 
     * @param distributionUser 分销用户信息
     * @return 结果
     */
    public int updateDistributionUser(DistributionUser distributionUser);

    /**
     * 删除分销用户信息
     * 
     * @param distributorId 分销用户信息主键
     * @return 结果
     */
    public int deleteDistributionUserByDistributorId(Long distributorId);

    /**
     * 批量删除分销用户信息
     * 
     * @param distributorIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteDistributionUserByDistributorIds(Long[] distributorIds);

    /**
     * 根据用户id查询分销用户信息
     *
     * @param userId
     * @return
     */
    public DistributionUser selectDistributionUserByUserId(Long userId);

    /**
     * 根据userId查询分销用户信息
     */
    public Long selectDistributorWhereUserId(Long userId);

    /**
     * 获取待审核分销员数量
     *
     * @return 待审核分销员数量
     */
    public int selectPendingDistributorCount();

    /**
     * 获取分销员统计信息
     *
     * @param distributor
     * @return
     */
    public List<DistributionUser> selectDistributorSummaryList(DistributionUser distributor);

    /**
     * 批量删除分销钱包
     *
     * @param distributorIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteDistributionWalletByDistributorIds(Long[] distributorIds);

    /**
     * 批量新增分销钱包
     *
     * @param distributionWalletList 分销钱包列表
     * @return 结果
     */
    public int batchDistributionWallet(List<DistributionWallet> distributionWalletList);


    /**
     * 通过分销用户信息主键删除分销钱包信息
     *
     * @param distributorId 分销用户信息ID
     * @return 结果
     */
    public int deleteDistributionWalletByDistributorId(Long distributorId);

    /**
     * 查询所有分销员基础信息列表（仅包含ID和姓名）
     *
     * @return 分销员基础信息列表
     */
    public List<DistributionUser.DistributorBasicInfo> selectDistributorBasicList();

    /**
     * 根据分销员编码查询分销用户信息
     *
     * @param distributorCode 分销员编码
     * @return 分销用户信息
     */
    public DistributionUser selectDistributorByDistributorCode(String distributorCode);

}
